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1.06 INTRODUCTION 


\ 


160 INTRODUCTION 


The SES TeXT FORMatter (TXTFORM) has capabitities for 
conventional formatting features as well as box and tabite drawing 
and other complex Functions. These capahilitiess together with 
automatic line justifications assure the user ao property 
formatted document. 


This document iItsel'F was oroduced using TXTFORM. 
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2e€ FEATURES NF THE FORMATTER 


2.0 EEATURES_OE_THE_EDRMAILER 


The following itens describe in generat terms some of the 


features 


available with the formatter. Detailed descrintions of 


these and other features can be found throughout the remainder of 
the document. 


LagQguage 


The Jlancuage Folfiows a free form concept for the input 
text data. Text or formatting codes can appear in any 
character oasition of a record with the followings 
axcenotions? 


The formatting code string must be preceded by = an 
ASCII character chosen as a delimiter ( bv default 
the reverse stants \ ) » in character position 1 
of a recorde This record witl contain only a 
Formatting code string. <A formatting code string 
consists of either a concatenated string of single 
fetter formatting codes or a single word 
formatting code such as \MARGIN. The string also 
includes whatever parameters may be associated 
with aocodte. <Any alpha character of a formatting 
code mav he elther upper or flower case. 


Example? A\slT2(eot) or V\SPaCE2leolt). 


Eoruatting Codes 


Formatting codes controit the format of the document and 
the manioulation of text within that format. Codes 
appear as words that describe the function such as 
NLENGTH and NEOLIN and others are alpha characters that 
represent a function such as \T for tabbing and \I for 
Indent. Some codes can be parameterized for greater 
flexibility.'! 


Loputi-_ Output 


Input to tha formatter is a file containing variabi:: 
length records. The records contain full ASCII set 
characters reoresented in NAS 6/12 Display code. Fach 
record is terminated hy a zero byte record (eol). The 
program presares a formatted document file utilizing 
the full eiqht-bit AST TY! character set. 
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Page _Eormat 


A page is comnoosed of designation texts such as tities 
and Folio tinesse and all other Formatted texts which 
forms the text hody. The page dimensions for each of 
these text tvyoas are separately defined by formatting 
codes. 


Line Seacing 


Formatted lines are orinted single spaced as a default 
selection. ‘Spacing can be changed dynamically with the 
ASPACE Formatting code. 


Line Justification 


The progran fustifies lines of formatted text by 
inserting blanks and maniputating whole words to fill 
the Jine lenaths oroducing an even right margine The 
process aiternates fron left to right and right to teft 
on lines of text to eliminate blocks of blank space, 
Non-justified text can be requested with a formatting 
code. The line Yength for non-justified text is Filled 
with as many whole words as possibie separated by one 
blank. 


Titles.andEolios 


6 TITLE tines can be selected with a formatting code. 
Another formattina code oprepares a folio line at the 
bottom of the nage,’ 


Headings 
Seven heading levels are available that provide 
automatic section numberinge Seven additional tevels 


can be selected that are not numbered, The styte of 
the headings can he varied with a formatting code. 


Section Numbering. and_Partlal_Listiog 
The formatter orovides the capability of generating 
section nunbers automatically. The user can also 
request oniy selected sections to be printed. 


aueglemental Lists 
Supolementa!l tists can be produced for use as tables of 
contents, fiaures and other cross-reference fists using 
various fornatting codes. 
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301 DESCRIPTION _OF_EQRMATIINGS COOES 
Selel TEXT FORMATTING CODES 
Va 


assis 

Text subsequent to the VA code wilt be orinted as it 
appears in each Inout record. The dimensions of the 
input record are described by the \RECORD formatting 
codee The text of each record is not justifieds 
leading blanks area not removed and spacing bianks are 
not added. Text records are orinted tas-ists starting 
at the current margin settings until the occurrence of 
the next Formatting code. Truncation occurs if the 
text of the Input record exceeds the fength of the 
outout record as described by the \LENGTH code. 


\BXXeV¥V¥9 0020272 


Begin. Box 
The box code draws a horizontal line from character 
position xx to 77. Vertical lines will be drawn from 
character vdsositiors x«xXsyvys00e22+ If the code \B is 
used with no oarameterss, a box will be drawn using the 
values defined by the previous \B code. Terminated by 
the VE code.! 


\BBoxxeVVs 00222 


Enlarge. Box 

The enftarge box code adds vertical tines in character 
positions Xxsvve0e0e'2% to those already begun by the \B 
codee Also draws a horizontal tine between the outside 
columns of this new boxe Maximum of 17 vertical lines 
may be activee. Terminated by the \E code. 17 
additional vertical lines are available with the \V and 
\VV codes. Terminated by the \E formatting code. 


\C 


Center 
The text following the \C code is centered within the 
fine tength defined by the \LENGTH codee The text to 
be centered shauld occur immediately subsequent to the 
record containing the \C code since other intervening 
codes nullify the effect of the center code. To center 
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more than 012 line of formatted texts, the \C code must 
precede each text record in the input file. Extraneous 
inter-word blanks are not removed from text to be 
centered, 


\E 

Fond Box 
The VE code draws the bottom horizontal tine of the 
current box and turns of f the vertical lines. 

ye 

Begin. Footnote 


The text following this code becomes a footnote and Is 
placed at the hottom of the current pagee The symbol 
that calls out the footnote Is placed by the user ina 
the regular text stream and in the footnote text. See 
the Examoles Section. Formatting codes occurring 
hetween the \VF code and the \Z code (end footnote) will 
affect only the footnote text. A maximun of 10 IJines 
eer page is allowed for footnote text. 


\VGaasdbdoeee V¥eZ2 


Horizantal_Line 


\Hnn 


Draws a line on the current formatted text line between 
any given character vositions (aa to bbs vy to 2zz)e 
Character oositions must be specified in numerically 
ascendina oairs. 


Yeading Level Selection 


nn is a tevat number 1 through 7 or 11 through 17 
correspondiyxg to hierarchical tevels of section and 
paragraph contro!. See the Heading Level Selection 
Table. Text following this code is formatted according 
to the heading styie selected and terminates atthe 
next formattina code or end of sentencee Heading text 
is not justifieds teading blanks are not removed = and 
spacing blanks are not added. The number of characters 
in the heading text Including blanks should not exceed 
the vatiue defined by (\LENGTH = \MARGIN). The range of 
fevel numbers 1-7 will cause the program to generate 
section level numbers automatically and orefix them to 
the subsequent taxt. Levels 11-17 provide the same 
format as tevels 1-7 hut do not orovide section 
numberse See the section on Automatic Section 
Numberina. nn fs also the fevel number referenced by 
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\Inn 


Iodent 


Adina 


the \LIST code in preparina suppiemental tists that 
include heading texte 


The \I code causes the subsequent text to be indented 
nn spaces from the feft margin in the formatted tines 
starting anew tinee If nn is not specifieds the tast 
deciared value of nn or the default value of nn (3) 
wild be used. nn equal to @ will start anew tine at 
the feft margins 


Hanging Indent 


\Knn 


Kese 


\L 


Box Line 


\M 


The text following the \J code begins at the current 
position in the formatted line according to other codes 
in effect. Hanging Indentation begins at the next new 
formatted fine, The new line and subsequent lines of 
Formatted text will he indented nn positions from the 
left margin as defined by the \MARGIN code. The \J 
code is terminated hy the next code that affects 
indentation.’ [Tf an is not specifieds the tast declared 
value of nn or the default value of nn(O) will be used. 


The \K endea affects subsequent text until the 
eccurrence of the release keep code (\R). An attempt 
is made to keep the text so bracketed from being split 
between pages as it fs formatted. If the value an 
(approximate nunber of Jlines to keep) exceeds the 
number of lines remnaining on the pages a new page iis 
started before printing the kept text. If an is not 
specifieds ane tine ts assumed. 


The \L code draws a horizontal line between the outside 
columns of the current box. 


Margin Note 


An asterisk (*) ds placed In the current oosition in 
the formatted text and a pointer ( less than = {(<)) is 
olaced in the riqht margin of the line. 
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A\Nann 


New Page 


Null 


ND 


OQOvererint 


A new page Is started hefore printing subsequent text. 
The ATITLE block witl be printed before any subsequent 
text. If nan ts not svecifieds the new page number 
will be one areater than the previous page. If 
specifieds the value of nnn will be used as the page 
number of the new pagee [Ff the page number is being 
automatically generated by sectionss the nnn oarameter 
will be ignored. Refer to the section on Automatic 
Section Numbertinge. 


The formatting code detimiters when used aiones can be 
used to terminate codes when no other selection is 
appropriate.! 


The \N code will cause the next two text characters 
agpearing In the source text to be oversorinted in the 
formatted text. The second character is the orimary 
character and will print over the first. The two 
eharacters can be dissimilar. QQverprintina to achieve 
a botdface apnearance for a string of characters can be 
obtained with the \BOLND formattino code. 
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360 FORMATTING CODES 
Selel TEXT FORMATTING CODES 


\P 

Paragragh — 
The \P faornattinag code provides the capability of 
formatting text In a paragraph style. The first line | 
of the formatted text will be indented and spaced 
according to thre ootions in the Heading Level Selection 
Table. Subsequent formatted tines will begin at the 
current left nargin. Records of text in the input file 
will continue to he formatted in paragraph mode until 
the occurrence of the next fornatting code affecting 
format. 

\9 

End_Verticai_Lines 
All vertical tines In effect by \V and \VV codes are 
terminated. 

\R 

Release. “ean 
Identifies the end af the text to be kent together. 

\Snn 

Skie 
nn blank tines are printed. If nn is Os a new fine is 
Started whenever the next text is to be printed. If nna 
is Os the naw line will be started according to the 
line soacing in affect bv the current \SPACE codes If 
nn is not 9s +j(&the number of blank fines printed are 
single-spaced. TF nn is not defineds the tast value 
assianed is useds or the default value of 0 Is used if 
nn was not oreviousty defined. 

\Tan 

\VeTan 

Tab 


The \Tnn codes and the \SETTA8 code together provide 
the capabiflity of starting text in defined character 
positions. These character positions are defined and 
given a reference number by the \SETTAB code. 


The nn parameter of the \T and \SETTA® code is the 
reference number of the tab position. The user assigns 
a reference number of 1-15 to parameter nn of the 
\SETTAR code and specifies what character position this 
number should refer toe For examples, if the code 
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NU 


Untab 


VSETTAB5399740 is defineds tab position number 5 will 
start in character voasition 30 of the formatted tine. 
Tab number 7 will start in character position 406. 


Text that is to start In character position 30 would be 
preceded hy a ATS code. ATT would begin subsequent 
text in character oosition 40. Tabbed text Is placed 
in the current formatted line and does not start a new 
line. 


If the \T cod2 is used without a reference numbers the 
text will start in the next character voosition defined 
as a tab stoo greater than the current position. 


The \eTan cod2 oerovides for tine padding using a 
period. Rilanks soaces are Filied with periods between. 
the tast character placed in the tine and the character 
oosition raferencead by the number nn. 


The character oositions of tab stops are defined 
relative to character position 1,» not the current 
\MARGIN settings 


If no \SETTAS8 code has been defineds the default 
character positions of the 15 tab positions available 
are in incremants of 5s beginnina with \T1 equal to 5 
through A\Ti5 equal to 75. 


The VU code Is used to adfow a mixture of tabbed text 
and untabbed justified text on the same line. Untab 
can ba used in conjunction with margin and tine tengt? 
changes to allow for columnar text in tables. See 
Examples Section. 


\VXX a VVs 00022 


Vertical Lines 


Vertical dines willl be drawn from the character 
POSTtTIONS XKoVVeese ZZ Terminated by the \Q codee A 
maximum of 17 vertical Lines defined by the \V or AVY 
code may be active. This does not include the 17 
vertical tines that may also be active using the box 
codes» VB and \Bhe IF another \V code anopears before 3 
\Q codes the orevious \V code will be terminateds but 
the current tine will contain both sats of vertical 
fines. 
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\VV KXe V¥9 00022 


Add _Verticai Lines 


\Xn 


Excention 


\Z 


Vertical lines will be drawn from character oositions 
XX9VV9 000229 in addition to any other vertical lines in 
effect. Terminated by the \O code. 


The exception code provides a means of entering text 
that is not a haadina into a supplementai liste. Then 
parameter corresoonds to the n parameter of the ALIST 
code. Each \LIST code identifies the level numbers of 
text to be inctuded In that supplemental list. 
Exception text level numbers can be from 1 to 17. The 
user assigns this number according to the inctusion 
desired ina list. 


All. exception text oreceded by an \X3 codes for 
examples, would aopear In any list requested by a ALIST 
code that included a 32 In the parameter string (\LIST3>» 
NLISTis394 etce). Since heading text is aiso included 
in supotementa! tists according to level numbers the 
\LIST3 In the above examptes would produce lists that 
also included \H3 heading text. Lists of exception 
text can be develoned that do not include heading text 
hy assigning a level nunber that Is not being used by 
headinase 


Exception taxvt levels 3 - 9 and 13 - 17 are indented in 
a supolemental fist» jevels is2s1ll and 12 are note 
Exception text Is atso Included In the current positios 
in the text stream according to the other formatting 
directives in effect. 


The text following the \Xn codes up to the next 
formatting code or end of sentences will be included in 
a list. exceotion text is not Jjustifieds leading 
bianks are not removed and spacing bianks are not 
added. 


End_Footnotse 


Specifies the end of footnote text, 
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ACHANGEs cececce 


eee 


\CODES 


The \CHANGE code indicates that the source text file Is 
composed of records that contain a fleld to be used as 
a source identifier. This field can be a maximum of 14 
character ov»ositions in tengthe The formatter assumes 
the first 7 vositions as the source identifier fietd 
and Ignores the tralting 7 characters which can be used 
for numerical seauencing. 

The source [Identifier In the field can be j] to 7 
characters left adjusted with blank fill. 

The ceccscce parameter its the base identifier against: 
which the first 7 characters of the identifier field in 
each record is comoared,. 

Formatted outout fines containing text from records 
whose source identifier is different fron the base 
identifier (eccecercs) will be marked by a revision bar 
(vertical bar). This bar appears 3 character sositions 
to the right of the right margin as defined by the 
NFORMAT or \LENGTH codes whichever is the greater. 

The olacement of tha source identifier field in each 
text record nust begin in the character position which 
follows the text limit described by the \RECORD code. 


LTbherefores a_\RECORD code. must. aepear.as. the first 


recorcd.in.the fille inorder to describe the location of 
the. source identifler fields. Ibe record containing the 
ARECORD code must NOT contain an identifiers 

For examoles assume the 14 character source identifier 
Field begins in character position 100 . A V\RECORD1,99 
code at the beginning of the file properly identifies 
the text portion of the source records and the tocation 
of the source Identifier field. Given a maximum record 
tength of 136 characters,» and the need to accomodate 
the 14 character f[dentifler fields the maximum text 
portion of the record Is 121 characterse 

The \CHANGE conde annoearing in the text file with no 
Identifiers (NECHANGED) will turn of f the subsequent 
generation of revision barse 

For information on the automatic generation of a 
formatted document with revision barss reference 
Section 6.1 on sequenced files and revised documents. 
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Codes/Erroc Listing 


\COMMENT 


\CODES causes a listing to be printed at the end of the 
document which contatns information about formatting 
codes useds ‘defauit settinas in effect and errors 
encountered in formatting the document. If V\CODES is 
not used» no codes/error listina will apoear. 


Comments_in_source text 


\DATE 
Qate 


VFOLIO 


Folio.Line 


The \COMMENT code alfows text In the source file to ba 
used for file documentation purposes. All records 
occurring between the \COMMENT code record and the next 
record containing a formatting codes will be ignored by 
the formatter. 


The dates specified by the fine of text following the 
date codes is right Justified on the third tine of the 
title biock.: 


The folio is the bottom tine printed on each page. The 
text followina the V\FOLION code wif! appear right 
adjusted to the right nargqin of the folio line. This 
text will anopoear on every page until redefined. The 
AFOLIN code avoearing without subsequent text will 
effectively remove the current \FOLIO text. The \VFOLIO 
text is terninated hy the next formatting code. Since 
the VFOLID JYine ts ftimited to the last line of the 
page» text exceeding the timit of the line as defined 
by the \FIRMAT code be truncated. Underlining is not 
permitted. Fol'lo text is not justifieds leading blanks 
are not renoveds and spacing blanks are not added. 


NFORMATaas bbenn 


SePeeLeecm eae 
\ 


QRMAT alloas the user to aiter the page dimensions 
for designation taxt. Refer to the descrinotion of Page 
Format in the fonventions and Definitions Section. 
\FORMAT defines the left and right margins for ATITLE 
hiock texts VFOLIOQ texts supptemental tlistss and 
sequence nunber slacenment. V\FORMAT also describes the: 
depth of the forn In lines from the top of forme 
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\HE ADC 


The value aa is the character position that will be 
used as the teft margin for the above mentioned text 
typese The defautt value is 7. 


The value bb estahtishes the right marain for the above 
text typese The effective tine tength is (bb — aa). 
The default value Is 75, 


The value nn defines the number of tines per voage from 
the top of Fforn. The placement of the \VFOLIN tine and 
the number of Vines available for the text body (for 
each ovage wit! he adjusted by the proaramns depending on 
the number of Lines in the VTITLE and subetitie block 
for the current pag2e The default value is 46. 


nity one \FIRMAT esode will be recoqnized and must occur 
hefore any formatting code that introduces text. Thea 
definition of \MARGIN and \LENGTH are unaffected by the 
\FORMAT statenant. 


Heading atyle 


\WUST 


dustifieasion 


VLENGTHx xx 


This code is used ta select one of three standard 
heading sets described in the Yeading Level Seltection 
Table. c can be either AsBs or Ce Each set defines: 
the Format of al} headings and paragraphs defined by 
the \Hn and VP? Formatting codes. See Heading Level 
Setection Tables 


he default mode of the formatter is tine justification 
to the right maragine The \JUST formatting code returns 
the progran to this mode if the \NOJUST code bas been 
in effect. Justification has no effect on the tast 
fine of a oaragrapnh or on A\TITLEs \VFOLIOs headinas 
exceptions centered and tas-is? text. If justification 
is in affects the program may adjust the space between 
any two words that are separated by one or more blanks. 


Line.Lenath 


The \LENGTH code establishes the right margin of a line 
of text in the taxt body by specifying the tast 
character onsition of the formatted tine. See the 
definition of Page Format in the Conventions = and 
Definitions Sactione xxx indicates the character 
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position retilative to character position zero» not the 
current feft marain setting. The default tJast 
character position is 75. The maximum value of xxx is 
ics. If xxx Is not defineds the default value of 75 
will be used. 


\LISTnane.enn 


augolemental Lists 
Tre ALIST code ovrovides a means of requesting 
supplemental! lists in addition to the formatted 
document. An entry In a list is defined as heading 
text or excention text. 


Heading text is itntroduced into the document by the 
heading level selection codess \Hnn. Exception text is 
associated with the Xn code, 


The nseneseeth oaraneters of the \LIST code are level 
numbers that corresoond directly to those used with the 
\VHnn and \Xn codese 


Fach occurrence of a \LIST code will produce a separate 
fist. Each suvolenental list oroduced will contain the 
text associated with the ievel numbers indicated with 
the \LIST code. For exampiet 


If the code \LIST1s354211 appears in the text Files the 
prooram will gqeanerate a supplemental list containing 
the text associated with all \NHis \H35 \H4Ss <\H1il = and 
alft  \Xl»s \¥3e9 \X%4& codes encountered in the file. If 
separate lists of each evel of text are neededs The 
\LIST codes used would bde3 

ALTSTI 

\LIST3 

ALT ST4 

\LTST1I1 


Level 1 heading and exception text would appear in a 
separate list From tevel 3 headings and exception text. 


If  ALIST ts used with no parameterss the default 
condition orevalits and a tist will be produced 
containing the text associated with all \NHnn codes 
appearina in the text file. 


The order of entries In a fist will be sequential as 
they occur In the text file. The order in which tists 
are produced will be the sequence In which the ALIST 
codes occure: 
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\MARGINan 


The page number where each entry occurred in the 
Formatted document will be printed at the riaht margin 
of the line in the list. 


Indentation of entries in a tist is as follows? 


Levei 1 Preaceeded by blank lines not indented 
Level ? Sinale spaceds not indented 

Level 3 Stngle soaces indented 2 spaces 

Level 4-7 Sinagie spaceds indented 4 spaces 


Levels 11-17 corresoond to levels 1-7 regardina spacing 
and indentation. The text line immediately Following a 
\LIST code wil! be used as a titie for that tist. The 
title text terminates at the next formatting code or 
end of sentence. The text for the ALIST title does not 
have leading blanks removed and will appear centered aon 
the page. Each supolemental list wilt start on ao=new 
page. The A\TITLEs sub-titie and \VFOLIO text lines will 
not appeare: The suonlemental tists are printed 
subsequent to the formatted document. 


All ALIST codes must orecede any \Hnan and \Xn codes In 
the text files: 


Left Macgin. Position 


nn defines the number of blank characters itn the teft 
margin of a line tn the text body. See the definition 
of Page Format in the Conventions and DSefinitions 
Sections The effective flowing text line is delimited 
by the first character position determined by \MARGIN 
and the tast character position of a line defined by 
the \LENGTH code. The default \MARGIN Is 10. If 
\MARGIN apnvears without a parameter», the default value 
witl be used. 


ANON JUST 
dustification Off 
his code turns off line justification for the 
remainder of the document or until a \JUST code is 
encountered to reinstate dine justification. 
\NOSEQ 


Non-Seaquenced. Document. 


\NOS&O requests the formatter to prepare the formatted 
document without seauence numbers appended to each 
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300 FORMATTING 


CODES 


30102 DOCUMENT FORMATTING CODES 


fine.  \NOSE9 Is the default mode of the formatter. 
The \NOSEQ code terminates sequencing initiated by the 
ASEQ code. 

VRECORDxxxs222 

Record Length 


NRECORD defines that oortion of a maximum 136 character 
input record that will be regarded as texte xxx is the 
First character oosition. 2272 is the last character 
position. If xxx apnears alones it will be regarded as 
defining the text oortion of the record to be character 
positions 1 through xxx. The maximum value of xxx or 
222 is 135. The \RECOIRD code must appear as the first 
record in tha source file if it is used. The default 
character posttions are 1 (xxx) and 136 (222). 


VSECTIONannsnnns ees 9th 


aection Listing 


\SE9 


Seguenced. 


\SETAP® 
CHK KKK KK Y 


The VSECTION code allows the user to request onty 
specified sections to he listed. ann refers to the 
major section number assigned to the text associated 
with an \HL headina code. Oniy one A\SECTION code will 
be recognized hy the program and it must appear before 
the occurrence of any VH1 code. The maximum number of 
sections that can he reauested is 32-2 The value of nnn 
ts saction numbers 1 through 999. Refer to the 
Convention seaction For Section Numbering and Partial 
Listing. 


Eormatted Document 

The \SEQ formatting code sequences the formatted 
document with Hine nusberse The number of fines to be 
sequenced oer oade i¢ that number calculated from the: 
depth parameter of the \FORNAT code. The sequence 
numbers start with 1 for each pagee ATITLE and \FOLIO 
lines are not sequenced. The sequence number appears 
right adjusted to the character position that is 5 
aqreater than the riqht margin character position 
defined by NLENSTH or \MARGIN» whichever is the 
greatere The A\NOSFEQ code returns the formatter to 
non=sequenced document mode which is the default node. 
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3el.2 DOCUMENT 


FORMATTING CODES 


ast_Agvendixz 


\SETEsc 


Appendices can be dascribed using the \V\SETAPP code. 
The A\SETAPP code is followed by a line of text in the 
form c=-xxxxxx where cc is an appendix identifier 
(jetters number or special character other than the 
current fornatting code delimiter)» and xxxxxxx is the 
title (name) of the anopendix. 


Appendices are created like sections using the \HI-\H7 
heading codes. The appendix identifier will be 
prefixed to the automatically generated section and 
pege numbers. 


The \SETSEC code can be used to set the number at which 
the aopendix section is to begins If VNSETSEC Is not 
used prior to the \VSETAPP codes the anrendix section 
number wit incrament from the section number currently 
in effect. 


The title (nana) of the appendix will appear as an 
entry in the supofemental tist ( if selected) prior t> 
the entries of the apoendix section and page numberse 


To change the current appendix identifier and/or titles 
re-define tha  \SETAPP code prior to the heading code 
(\H1i) where the change is to apvoeare 


iet_fornattingcade_dellaitec 


\SETSECnan 


This code can be used to change the formatting codes 
delimiter Fron the default characters \ » to (c)»s any 
full ASCII set aqraohic. Care should he taken in 
selection of the character to be useds since the 
appearance of the detimiter in character position 1 of 
any record wilt cause the remainder of that record to 
be treated as formatting codes. This can be confusing 
if a frequentiv used alphanumeric character is chosan. 
If (c) is onitted and the code appears as \SETEs or 
\SETE » the default delimiter character {(\) will be 
restored. 


ast section Number 


ASETSEC supotlies a section number (nnn) that Is to be 
used by the automatic section numbering feature as a 
new base section number from which subsequent 
sequential section numbers are generated. nnn allows a 
section number fron 1-999. 
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\SETSEC can be used anvwhere in the source file and its 
effect will be as follows: 

Ifs for axamples the formatter Is generating text 
within Section 4.9 and a VSETSECnnn code is 
encountereds the next new section number generated will 
be ann. rather than 5.0.6 

The affect of the \SETSEC code ts detlaved until the 
start of the next section. Each succeeding section 
will be numbered Incrementatiy from none for the rest 
of the document or until the occurrence of another 
\SETSEC coda. . 

If automatic section numbering is not in effect (no 
NHI-\H7 codes are being used) \SETSEC is iqnored. 


\NSETTABnnxxennyyoe eAN22 


aet_Iabs 


The character oositions on ai line of the formatted 
document can be deciared as tab positions by the 
\SETTAS8 formatting codese A maximum of 15 tab 
positions is: allowed. Character oositions are numbered 
from character voosition ls not the current \MARGIN 
setting. 


In the \SETTABR codes the ran parameter refers to a 
reference number the user assigns to ai character 
position that Is tn be a tab stope This is the number 
that is then used hy the VInn formatting codes when the 
actual tabbing 9° subsequent text is to occure The 
£xavyez7z in the NVSETTAB code refers to the character 
position In which the text is to start for that tab 
settinge For axanoles if V\SETTAB1200230 is defineds 
the code \T1 would cause subsequent text to begin in 
character oosition 20 of the current tinee Text would 
begin in position 35 folftlowing a \T2 code. Character 
positions nust be designated by 2 disgitss such as 
29903909. 


Tab settings remain in effect until individually 
redefined. Tn the above examples the tab position 
referenced by numher 2? could be changed to character 
Position 49 by defining a \SETTAB240 code.» This would 
not disturb the setting of the tab voosition referenced 
by the number 1. 


Tabbed text can then be manioulated by changing 
character postitions in the \SETTAB codes without having 
to disturb the Tran codes distributed throughout the 
texte. IF \SETTAR appears with no parameterss the 


default values wild be assianed to the 15 tab 
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positions. The defaulted vwalues are 5 for position one 
and an increment of §& for each succeeding position. 


\SPACEn 


Seacing of Lines 
The default mode of the formatter is single spacing. 
The space code allows the inter-line spacing to be set 
at one {n"1) or two (n#2) tines. If n ts not 
specifieds singla soacing will be set. 


\TITLEn 


aslest.title 

There are 6 titie2 lines available in the titie block 
that begins each new pages n ( 1-6 ) is a positional 
reference toa the olacement of the subseayent text of 
the title Itself. The text of each title selected will 
appear in the titYe block on each page of the document. 
To change the text of a titie tine in the blocks 
re-define that tit!e and supoty a new text tine. If 
\TITLEn apoears without subsequent texts» the titie line 
nwild be removed Fron the tittle bliocke. Titie text is 
not justified» teading blanks are not removed and 
spacing blanks are not added. The number of characters 
in a tittle mast be limited to the definition of title 
fine lenath described by the \FORMAT code. If nis not 
specifleds 1 will be used. 


\TODAY 


Todays. Date 
This code Is used instead of the code \DATE whenever 
the current date is desired. The current date will 
appear in the same position in the title block as the 
date supplied by \NATE code. This is the third line of 
the titie bliock,.: 
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JZele3S UNDERLININGs, BOLDFACE AND BLANK CODES 


VBLANK ann 


Blanks_as_Text 
ann number of blanks will be Inserted as text in the 
current oosition of the document. If nnn is not 
specifiads 1 will be used. 


\BOLD 

Boldface text 
The text foltowing the BNLD codes until the occurrenc:? 
of the \B30FF codes willl appear In boitdfaces achieved by 
overprinting each character with itself. Boldface text 
can also be underlined. 

\BOFF 

Boldface Text off 
The \BOFF code terminates the \BOLD code. 

VUNDER 

Underline 
Characters in the formatted text following this code 
wild be underlined, Yinderlining will be terminated 
upon the occurrence of the \UGFF formattina code. 

\UOFF 


Underclining_off 
This code terminates underlining initiated by the 
\UNDER code. 


The undertine character can he input as text from aeie§terminal 
when the ASCII and TERM+713 command are in effects. 


In cases where the undertine character itself is desired as a 
character representation and cannot be input directly; or where 
repetition of entry Is undesirables the \8SLANK code can be used 
with the \UNDER codee For example: 

VUNDER 
V\BLANK390 
\VUOFF 

aould produce 
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In using the \UNDE? and \RAILD codes to emphasize texts a space 
must he provided bv the user In the source text If a space is 
intended to appear between the eamohasized text and surrounding 
text in the formatted line.. . 


This reauirement occurs In two unique sequences in the source 
texte 


1. In setectina VUNDER and/or A\BOLDs If the text to be 
emphasized is to appear as?! 


word begin_underlining 
the source seayence should he 
word 
\under 
begin underlinina 


* Note the space ortfor to the be 


2% In terminating emphasized text with \BOFF and/or 
\UDFF, text that Is to appear as? 


boidface text conoleted 
the source sequence should be 
boldface taxt 
\boff 


completed 


* Note the space prior tn the ce 
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363 SUMMARY OF FORMATTING CODES 


The following is a short list of the Formatting Codes as they 
would appear in us@e Those codes that expect subseauent text are 


so noted. 

\A 4s Is 

Text 

\BXX9¥Vp 000277 Reqin hor 

NABXX aD VV eee 0 ZZ Entarae box 

AC Canter 

Text 

\E End hox 

\F Begin footnote 
Text 

N\GX Xe VV¥e000 22 Hortizontal fine 
\Hnn Heading level selection 
Text 

\Inn Indent 

Text 

\.Inn Hanging indent 
Text 

\Knan Keen 

Text 

AL Rox line 

\M Marain note 
\Nonnn New page. 

ND Nyerorint 

\p Paragraph 

Text 

\a End verticai lines 
\R Ralease keep 
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\Snn 


\Tnn 
Taxt 


\.eTnn 
Text 


VQ 
\VXX a VV9 00 0 2Z 
A\VVxKXs V¥9 000722 


\X¥n 
Text 


\2 

\ 
\BLANKnnn 
\BOFF 


\B9L0 
Text 


\CHANGE »sccccecce 
AC ODES 


ACOMMENT 
Text 


\DATE | 
Text 


\FOLTO 
Text 


\FORMATaasbbsnn 
VHE ADC 

\JUST 

\LENGTH xxx 


ALISTnsnseeann 


Skip 


Tab 


Dad and tab 


Yintah 
Vertical! lines 
Add vartical lines 


Exceotion 


End footnote 
Nul ft formatting code 
Insert bianks as text 
Roldface off 


Roldface 


Shange (revision) bars 
Codes/trror jist generated 


Commented source file 


Nate 


Folio tine 


Page form margins tengths deoth 
Heading style 

Justification on 

Print line length of text body 


Suoptemental list 


60460290 O1 


3-22 
COC =~ SOFTWARE ENGINEERING SERVICES 
13 DEC 33 
TXTFEORM 1.5 Reference Manua! REV: 1 
366 FORMATTING CODES 
323 SUMMARY QF FORMATTING CODES 


Text 

AMARGINN 

\NO JUST 

\NOSEQ 

\RECORDxxxs 227 
NSECTIONannsnanese nnn 


\SETAPP 
Cm KKK KKK 


\SETEsc 

\SE9 

ASETSECnan 
ASETTABAnxxsnnyysnnzz 
\SPACEN 


ATITLEn 
Text 


\TODAY 


\UNDER 
Text 


\UOFF 


Left marain of text body 
Justification off 
Non-sequenced formatted file 
Input record field delimiters 


Partial listing by section 


Set Aopendix 

Set code delimiter 
Seauenced formatted file 
Set Section Number 

Set tabs 

Line soacing 


Select titie line 


Todavs date 


Underline 


Undertining off 
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4.0 CONVENTIONS aND_DEEINITIONS 


4.1 CONVENTIONS 
Page Format 


The allocation of space on a cage for the placement of text 
defines the format of a pages. The formatter views a page as 
containing two text types? 


1) Designation Text = Text of this type in some way 
identifies or describes a reiationshio of text from page 
to pages. Included In this type are? 


Sequence numhers 
Date 
Page nunhers 


and the text associated with 


Title and suh-titie block 
Folio tine 
Supplemental listse. 


2) Text body - The bodv ts the oprincipat text of the 
documents axcttusivea of desianation texte All the 
formatting codes» axcenot those relating to designation 
texts, affect the text body. 


The program places the titie hlockss if presents at the top of 
the form and the folio fine as the last tine of the form. The 
user may adjust the placement of designation text with the FORMAT 
codees 


litle Block Selection 


In preparing the title hiocks, the program will orovide a 
format containing the following information? 


A title block of one to six title liness, each tine chosen by 
the user with the A\TITLEn formatting code. 


A sub-title block consists of 5 liness the first Is a hyphen 
line followed by two tines indicating the major and 
minor section levels of text in effect at the beginning 
of the current voages followed by another hyohen tine 
and a blank tines The major section level is the 
current \HL code selection in effects the minor section 
is the \VH2-\H? eode in effect. The sub-titie bloc: 
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4.1 CONVENTIONS 


will not appear if no \HI-\H7 codes have been used. 
Current date untess N\DATE code was used to select another. 


Page number which Is the current major section number and 
seauential oage within that section or a numerically 
sequential number ff no section numbering is in effect. 


If tess than the maximun number of titie tines available is 
selecteds those in use wit! be compressed to provide ai compact 
title biock. An examote of the title block is: 


PAGE 1-1 
TITLEL Text 

MM/DD/YY 
TITLe2 Text 


TITLEn Text _ 
§e0 Heading 
Sele--Heading 


{biank line) 
Automatic Section oumbering 


Section numbering by the formatter is introduced through the 
use of the heading level selection codess V\H1I-\H7. The text 
associated with these codes» together with the anpropriate 
section number generated by the programs becomes part of the 
formatted text. 


Automatic section numbering will be hased on the occurrence of 
the heading selection codess \HL=\H7, 


Sections are numbered and incremented by the occurrence of H1 
codese The text fines associated with successive \H1 codess for 
examples will be prefixed bv the section numbers 1202 ce se095e00 


The first occurrence of anv \H2-\H7 heading code will cause 
that section ftevel nunber to be l. Each subsequent occurrence 
will incrament that level number by one. Section level numbers 
will return to 0 when anew section is started by the next \H1 
heading codee The hierarchical sequence is as follows’ 


\H1 $29 

\H2 Sel 

\H3 sel.l 
\H4 Seolwlel 
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\H5 Selelele! 
\HA seoleleletel 
\H7 Solololateiol 


The range of the section number {s) and the section Ieveli 
numbers (1) is 1-999. It should he noted that the section tevel 
numbers should be counted as text characters when it comes to 
determining the tength of the Formatted text line. 


The user may wish to arrange a document that makes use of the 
automatic section numbering feature but stilt t allow portions of 
the text to be headed and included in supplemental tists without 
appended section numberse 


In the description nf the heading level selection codes» 
NH1-\H7s the on value of 1-7? corresponds to the level of section 
number requested for the subsequent text. The appropriate: 
section number will be determined by the program and prefixed to 
the heading text supolifed hy the user. 


As seen in the Heading Level Selection Tables the \Hnn codes» 
together with the \HEADc codes orovide a variety of format style. 


In order to allow the sama styie headings as described for 
NH1-\H7» a subset of sellection codess \HLI-e\H17 will provide the 
same format style as its 4H1l-H7 counterpart but will not be 
prefixed hy section numbers. 


If aeuser wishes to oroduce a document without any program 
aenerated section numberss the \H1LI-—-\H17 should be used 
exclusively. 


Therefores a text file that contains the \Hnan codes will 
produce a document with the following characteristics: 


\H1L=-NH7 codes contro! automatic section numbering and 
partial listing oy section requests. 


If a tevel number Is missing from the sequence \H2—\H7»s the 
section number generated for that tevel will be zero; 
J} o@e3 1.1.e0elel. indicates no \H3 heading was 
selected. 


If no \H1 occurs In the text but subsequent \H2-\H7 codes 
dos the entire document will be treated as Section 1.0 
and the page numbers will be l=nnn. If the ASETSECnan 
code has bean invokeds the section number supplied is 
nnnede 


The first occurrence of an NHL code starts the page 
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numbering at s-9 even if \HLI-\H17 headings have 
apoeared eartier in the text. Page numbers will remain 
in the form s-0 throughout the documents where s Is the 
section nunber and o is the page within the section. 
Page numbering will be non-sectioned until the 
occurrence of the first \Hn code. 


If no \HI-\H? codes are useds no automatic section numbering 
takes piace and no sub-title block is produced. 


Partial Listing by section 


It is possible to request a listing of sections of a document 
rather than the entire document. The sections that are reauyested 
to be printed appear as parameters oan the  ASECTION formatting 
codee Onty sections that are created through the use of \HIL-\H7 
heading codes or supplied by the \SETSEC code may be referenced 
by the \VSECTION code. 


The string of section numbers requested to be printed should 
refiect the section numbers as they will appear in the formatted 
document. The smallest unit of text that can be requested for a 
partial listing Is a section. The section numbers refer to the 
(s) portion of the ss.) numbers that have been generated for thea 
document by the program. 


4.2 DEEINITIONS 
Wocd 


The formatter recognizes a word as a contiguous string of 
ASCII graphic characters. 


Parameters 


Those formatting codes that have eptional or required 
parameters are designated «ith one of the following suffixes. 
The parameter notation will indicate the maximum range allowed 
for that parameter tvyoe. For examples an nn parameter impiles 
that the value of the parameter could be 1 through 99. A 
character position parameter of aa would accept positions 1 
through 99-6 Codes that reaulre teading zeros on numeric 
parameters tess than 19 witt specifiy this in the code 
description. These varaneter notations are defined as follows; 


aasbbe xKxsyYysZ2 
XXX9VYVYV9ZZ7 Indicates numeric character positions. 


n A numeric count of character positions or 
number of Liness or ai designation 
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of tyoe such as heading selection. 
n has a value of 1-9. an would 
reoresent 1-99» nnn is 1-999. 


c An ASCII character Is requested as a 
parameter. 
text In some casess text can be considered a 
parameter as in the heading and 
date selection codes. 
End_of sentence 


An end of sentence is defined as a period followed by one or 
more blanks3 also when a oeriods exclamation point or question 
mark is Followed inneadiatelly by one or more close parenthesis 
and/or quote and then a spacee The program will Format a minimum 
of 2 blanks hetween sentences. Nther blanks may be inserted 
during the justification orocess,. 


Ecroc_Messagses 


The program produces the fFottowing error messages which are 
appended to the formatted file, 


The page and tine number where the error occurred wii! 
will appear on the sane tine as the messages 


Column xxx overlaid 
‘Iser requested more than one character placed 
in’ a character position by some means other 
than overorintinga.e 


Line overflowed 
Formattina codes in effect produced a 
formatted text Line tonger than the specified 
line tinit.e 


Box apoend but no oravious box code 
A \38 ecode was encountered without having a 8 
code precedeing it to define the original 
size of the hoxe 


SETTAB error 
Faultv tab setting paraneter. 


Word count error 
Messaae generated when the justification 
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process anes awrye 


Unrecognized formatting code 
The character string following the formatting 
code dalimiter is not valid. 


In the case of oarameters that exceed the designated value 
limitationss the program will! substitute the iast correct value 
set for that code, 


Defauits 


The folifowing selection of page dimensions wil! be considered 
the defauit conditions. These are assenbly-time values of the 
SES Text Formatter proarams TXTFORM, 


\MARGIN 10 
\LENGTH 75 


affective line tength (\LENGTH<\MARGIN) 


VRECORD Character positions 1-136 of inout record 
NSPACE Sinale soacing 

JUST Justification on 

\HEAD Style A 

\NOSEQ Non-Sequenced document 

\FORMAT Page form margin 7s tength 75s depth 60 
\TODAY Todays date 

\SETTAS 1059 210931594209 52526305 73598402945,» 


195991155912609136591470 91575 
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520 EXAMPLES 


Columnac_Text 


COLUMNS It is ovoosstibte to produce 
columnar text with the 
tabbings margin and fength 
codes. Since Flowing text 


begins at the margin and is 
justified as to fengthsa 
column can ha defined with 
these codes, 


EXAMPLE 
\Margin39 
\Lengths% 
producing a twanty character 
wide colunn.: The box 


dimensions are 159 28s 65. 8v 
definina a tab settings a 
Yabel or other text can be 

. offset from this columne 
LABEL 


pe we Aw we OS we He Oe He Oe Oe te we Oe Ee we ee Oe 


0 ae Oe HO oe ee ee Oe i le Oe ee Om Oe oe we 
+> ip 8 me Om Be Oe we Oe Oe OO He we Oe Oe Be oe ae om Oe 


he ee ce ee ae eee ee ee ae mene eee ee eee nee nee eee mmo fe An ene cee ee ae sa ee aa ee Oe ee ee ee —— 
} By switching the H EXAMPLE H 
column assignments» ; 3 
: the flelds can ba 3 H 
$ reversed. Mar ain ; ; 
$ ds now 179 tength H H 
$ Is 36 and the box 5 H 
: dimensions are set ; H 
$ at at 15940» = and H H 
$5 85 The box is ; H 
$ completed with the ; H 
; \e codee H : 
$e ee ee ee ee ef ee ee ee ae me ae ee 
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Boxss_and Lines 


Another examote of the use of box and line codes demonstrates 
the ability to poproduce flow diaqram-type figures. 


The first sequence of codes produced the ensuing box. 


\B30945 

\s5 

\e 
fawn mew enn ee no + 
3 ; 
H } 
H H 
H H 
H i 


To insert text In the boxs the sequence becomes? 
\b30945 
\s? 
\il?7 Marcin was sat at 15 (tabbing could also be used) 
TEXT 
\s2 
\e 


TEX T 


> 2-2 we 2 we oe 
pp we ce ne we we 


<> ap Oe ae a a ED OD OD a ee Om - 
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5eQ EXAMPLES 


To add connecting !itness the horizontal and vertical line 
drawing codes can be used: 


\a end this vertical olece 
\b30945 

\s2 

\1I17 

TE XT 

\g15 9369465959 start horizontal 
\v596 start vartical 
\s3 

\e 

\s6 

\a 

\b42 953 

\s5 

\e 


The Figure produced is! 


bw 2S Oe we 


$ 9 
; : 
wenn nnn nnn te TEX T oe | 


a 2 
a a 
s 3 
9 a 
, a 


ee S06 BE we OS oe 84 we CGE Oe 


> 46 se 28 2m ae 
> we we we we we 


t 
j 
j 
j 
’ 
j 
j 
f 
j 
{ 
i 
i 
' 
' 
i 
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5e9 EXAMPLES 


Tabular_Items 


To produce a table of Itenss the tabbing features can he used. 
In the following examoles the tabs are sets 


\seattab729» 82495021059 


Ry using the \T and the \.F codes with the appropriate tab 
setting number a table is oroduced. An examoie of one tJline of 
the list would be 

\t7 

ne 

\t8 

Pool table 

\et9 

> green 


See eeeavreeseeeeseveseneeseanenenevnnnsensevenes 


One Pool Tabla esnssessselese> green 
Ten PUCS eeosesesssvecseser numbered 
Rack Balls eesesesessesseee> colored 


SROKA R HSS SHORES RA SOHRLORe Ae AHRHSH HAH HSH OSHS ERO LEDS 


The code \.t1C¢ produced the dotted lines. 
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Eootnotes 


The footnote featur’e allows references from within ai vortion 
of text to post-ser‘iot text at the bottom of the page. It is 
important to remember that the calling out of the footnote text 
must occur at the oosition in the text stream that the footnote 
symbol appearse This is the onliv way the program can assure that 
the footnote text will annoear on the same page as the reference 
symbol. 


The footnote avpearing an this page and the text containing 
the reference to it was input as follows: 


\p 
Saint-Exupery on hunan relations: ''We Forget that there is no 
hooe of joy except in human relationss! *#* , 

\F 

**¥* Aiso3 "YHapnoiness! [t is useless to seek it elsewhere than in 
this warmth of human relations. Our sordid interests Imprison us 
within their walis.  Jnivy a comrade can graso us by the hand = and 
haul us free.! 

\2 

from the book Winds Sand and Stars!,. 


As it woulds thens aonear In the document? 


Saint-Exupery on human relations: %IWe forget that there is no 
hope of joy except in human relationss! *** from the book "Winds 
Sand and Stars. 


**#*% Also} ‘Happiness? [t is useless to seek it elsewhere than in 
this warmth of human relations. 9Our sordid interests imorison us 
within their walls.  IJniv a comrade can grasp us by the hand = ani 
haul us free.! 
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Insertion of blanks _as_text 


The formatter ianores extraneous blanks in the text stream. 
Therefore,» it becomes necessary to use other means to introduce 
more than one blank into the formatted text. 


This can be done in several ways? 


1) The VA codes as~is»s does not iInteroret the text it 
references but rather aflows the user to place the text 
data in the Inout record in the format desired for that 
print tinea Blanks» therefores are not ignored but 
printed as encountered, 


2) The \BLANKnan code reauvests the formatter to insert nnn 
bianks into the current position in the formatted text. 


3) The following codas will not have extraneous bianks 
removed fron the associated text; therefore blanks will 
be considered as part of the text: 

LIST 

NFOLIO 

\TITLE 

\X fexception?) 

AH (headina) 

\E (centered text) 


Tabis_of Conteaots 


A table of contents can be produced by using the ALIST code. 
(See the dafinition of \LIST). The text foltowing the \LIST code 
can be "Table of Contents! or any descriotive statement. The 
list produced will he oprinted following the document. Each 
supplemental sist requested will be numbered consecutively by 
page le ZevraNne 
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600 USING _THE_FORMAITER_UNDER_NOS 


The source file of text and formatting codes is created unde 
NOS in ASCII mode. 


Conversion orograns are available that will convert the 
formatter ASCTI output File to a NOS 6/12 fille for display on a 
terminal or ortntinge 


These conversions are avallable with the UTL utility described 
In the SES Users Handbook, 


A formatted documert can be obtained by using the utilities 
and NOS commands described in the SES Text Formatter material in 
the SES Users Handboox. 


Gel SEQUENCED SOURCE ETLES_AND REVISED DOCUMENTS 


The Facility also orovides for the generation of a document 
with revision bars Two source files must be vprovided3 a base 
File containing the ortainal (Chase) text and a change file which 
contains the original text edited with the desired changes. The 
files are compared and a revision file is generated that contains 
the appropriate source fPlie Identiflers. The necessary \VRECORD 
and \CHANGE codes are Inserted In the revision file and a 
Formatted document is produced with revision bars marking the 
changed tert. This feature is described in the Utilities section 
of the SES Users Handbook. 
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